home *** CD-ROM | disk | FTP | other *** search
/ La Bible Des… Fonts / La Bible des... Fonts.iso / Utilitaires / PS2EPS+ 1.0 / Documentation / PS2EPS+ Documentation (TEXT) next >
Encoding:
Text File  |  1995-03-19  |  9.9 KB  |  291 lines  |  [TEXT/ttxt]
  1. ⌐ 1995 Peter Lerup
  2.  
  3. PS2EPS+
  4.  
  5. A PostScript conversion utility
  6.  
  7. Version 1.0    1995-03-19
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. What is it
  13.  
  14. PS2EPS+ is a Macintosh program that can generate visible pictures from single
  15. page PostScript files. The primary usage of this program is to generate
  16. Encapsulated PostScript files (EPS) from plain PostScript (PS) text files.
  17. Both Macintosh and Microsoft-Windows EPS files can be generated. The program
  18. can also save the pictures in the following formats: PICT, TIFF, PCX and
  19. Macintosh startup screen.
  20.  
  21. The conversion of PostScript files into visible pictures is done by a
  22. Macintosh version of Ghostscript, a freeware (originally UNIX) program from
  23. the Free Software Foundation. PS2EPS+ acts as a front program for
  24. Ghostscript. Note however that PS2EPS+ is NOT Ghostview (for those who know
  25. what that is). It only accepts single page PostScript files which have a DSC
  26. bounding box comment.
  27.  
  28. I wrote this program several years ago, but after following the Usenet news
  29. group comp.lang.postscript for some time and seeing many people looking for
  30. an utility like this, I decided to distribute it as a freeware program.
  31.  
  32. Requirements
  33.  
  34. PS2EPS+ should be able to run on any Macintosh with color QuickDraw and
  35. MultiFinder or System 7. At least 1 MB of memory is required but a more
  36. realistic value is 4 MB. In order to generate color pictures the Macintosh
  37. must have a color graphics card. The program is a 68K executable as I
  38. neither own nor have access to a Power-Macintosh.
  39.  
  40. Installation
  41.  
  42. Just unpack the archive onto your hard disk. The folder hierarchy must be
  43. maintained, i.e. the folder GS and its subfolders must reside in the same
  44. folder as the PS2EPS+ program. 
  45.  
  46. About Ghostscript
  47.  
  48. Ghostscript is a freeware PostScript interpreter from the Free Software
  49. Foundation. The program is distributed through the GNU general public
  50. license. A copy of this license can be found in the GS folder.
  51.  
  52. Ghostscript is a wonderful piece of software written by Peter Deutsch and
  53. others. It originates from UNIX but has been ported to almost every other
  54. platform.
  55.  
  56. I have made my own Macintosh port of Ghostscript using version 2.3 of the
  57. source code. Today this is quite an old version by I think it is sufficient
  58. for the usage together with PS2EPS+.
  59.  
  60.  
  61. 2. Program menus
  62. ----------------
  63.  
  64. PS2EPS+ has only a few menus and is quite straightforward and easy to use.
  65.  
  66. File menu
  67.  
  68. Open
  69.  
  70. Use this entry to open a PostScript file. All files of type TEXT, EPSF and
  71. EPSP can be opened. TEXT is the normal type for plain PostScript files, EPSF
  72. are Macintosh Encapsulated PostScript files and EPSP are ditto for
  73. Microsoft-Windows. If the selected file is a TEXT or EPSP the program starts
  74. generating a picture from the PostScript code immediately. 
  75.  
  76. When the generation has completed the picture is shown within a window
  77. representing the file. If the generation failed for some reason an error
  78. message will be shown and the file is closed. The generation can be stopped
  79. at any time by pressing the command key and the period key simultaneously.
  80.  
  81. If the file is of type EPSF with a preview already present in the file, the
  82. preview will be shown within the file window and no generation is made. A
  83. new picture can however be made through the command regenerate, see below.
  84.  
  85. Open the files in the samples folder to see how it all works. The samples are
  86. from the Ghostscript distribution.
  87.  
  88. Close
  89.  
  90. Closes the file window. If the file has not been saved a save prompt will be
  91. shown.
  92.  
  93. Save
  94.  
  95. Saves the file as a Macintosh Encapsulated PostScript file, i.e. the original
  96. PostScript code and a screen preview. 
  97.  
  98. Save As...
  99.  
  100. Saves the file as a Macintosh Encapsulated PostScript file with a new name.
  101.  
  102. Save A Copy As...
  103.  
  104. This entry can be used to save the picture in another format than Macintosh
  105. EPS. The save file dialog contains a popup menu in which the desired format
  106. can be selected.
  107.  
  108. Page Setup...
  109.  
  110. Just the normal print selection dialog.
  111.  
  112. Print...
  113.  
  114. Print the front file window. If the selected printer is a PostScript printer
  115. the PostScript code will just be downloaded to the printer. When a non
  116. PostScript printer is selected the screen picture will be sent instead.
  117.  
  118. Preferences...
  119.  
  120. Displays a dialog box that controls how the picture conversion is made. The
  121. following options are available:
  122.  
  123. Generate color picture: When PS2EPS+ generates a picture it uses the current
  124. settings of the active graphics card i.e. the settings made in the monitor
  125. control panel. In order to force black and white pictures on a color display
  126. this check box should be unchecked.
  127.  
  128. Picture resolution: The program can generate pictures with resolutions
  129. between 18 and 300 dpi. Resolutions above 72 dpi is only meaningful if the
  130. picture should be saved as TIFF or PCX. Lower resolutions can be used to
  131. minimize picture memory requirements.
  132.  
  133. PICT content: When saving the picture in PICT format (PICT or Mac EPS) the
  134. content can be either raster or objects. The latter normally requires less
  135. memory but gives a slower screen update when an EPS file is used within a
  136. document.
  137.  
  138. Compress TIFF: Check this box in order to get compressed TIFF files (TIFF and
  139. PC EPS) . The compression method used is PackBits.
  140.  
  141. Save: Make current setting permanent (used in subsequent runs of the
  142. program).
  143.  
  144. Default: Apply default settings.
  145.  
  146. Quit
  147.  
  148. Guess what.
  149.  
  150.  
  151.  
  152. Edit menu
  153.  
  154. The edit menu has the normal expected behavior. Note however that it is
  155. possible to paste any picture from the clipboard into an EPS file. It is of
  156. course also possible to copy a generated picture to the clipboard.
  157.  
  158.  
  159.  
  160. Change menu
  161.  
  162. This menu can be used to modify the current picture.
  163.  
  164. Regenerate
  165.  
  166. When the preferences has been changed, this command can be used to update the
  167. current picture according to the new settings. It can also be used to change
  168. the picture when an EPS file with an existing preview has been opened.
  169.  
  170. Raster picture
  171.  
  172. Can be used to generate a raster picture when an object picture was generated
  173. without having do redo the PostScript conversion.
  174.  
  175. Reshape EPS...
  176.  
  177. Use this entry to change the size and or rotation of a picture
  178.  
  179.  
  180.  
  181. 3. Appendixes
  182. -------------
  183.  
  184. Technical information
  185.  
  186. As stated before PS2EPS+ uses Ghostscript to generate a picture from
  187. PostScript code. PS2EPS+ launches Ghostscript and provides the necessary
  188. information about the conversion in a parameter file. My Macintosh
  189. Ghostscript driver generates a PICT picture. This picture is put on the
  190. clipboard when Ghostscript terminates and it is then retrieved by PS2EPS+.
  191. The conversion from PICT to other formats are made within PS2EPS+ by my own
  192. algorithms and not in a Ghostscript driver.
  193.  
  194. The Ghostscript program is located in the folder GS and can be launched by
  195. itself from the Finder but the usage of this is quite limited. The program
  196. prompts for a PostScript file and if none is given the standard UNIX command
  197. line is presented. Any generated picture is just shown in a window. One
  198. possible usage of the standalone Ghostscript program is for PostScript
  199. debugging.
  200.  
  201. The Ghostscript port is written in Think C 6.0 for Macintosh.
  202.  
  203. PS2EPS+ is written in Think C 6.0 for Macintosh using the Think Class Library
  204. TCL.
  205.  
  206. The default memory settings for PS2EPS+ is 1 MB. When converting large
  207. PostScript files it might be necessary to increase this value. This is done
  208. in the normal way from within the Macintosh Finder. As PS2EPS+ and
  209. Ghostscript are two separate programs both programs must have a sufficient
  210. amount of memory when treating large PostScript files. It is however only
  211. necessary to modify the memory settings for PS2EPS+. Whenever PS2EPS+ is
  212. started it modifies Ghostscript memory setting to be the same. This behavior
  213. might upset some virus detectors I guess.
  214.  
  215. PS2EPS+ uses the current monitor settings for colors when generating a
  216. picture i.e. maximum number of colors should be set in the Macintosh monitor
  217. control panel to obtain high quality pictures.
  218.  
  219. The fonts in Ghostscript has somewhat limited quality, but should be
  220. sufficient for screen previews. I have only included the most basic fonts. 
  221.  
  222. PS2EPS+ can also handle PostScript files generated by the Macintosh
  223. Laserwriter printer driver. It applies a patch to the standard Apple
  224. dictionary which makes it possible to use these files as EPS-files. This was
  225. quite a good idea at time of printer driver 7.X and earlier but after the
  226. introduction of Laserwriter 8.0, which can generate EPS files directly, this 
  227. function is of course of limited interest.
  228.  
  229.  
  230. Distribution
  231.  
  232. PS2EPS+ is freeware i.e. you can use it free of charge. If you however find
  233. any use for this program it would be interesting for me to know. Please send
  234. a mail to one of the addresses listed below or preferably send a nice
  235. postcard of your home town.
  236.  
  237. Even though PS2EPS+ is freeware, it is not in the public domain, I reserve
  238. all rights to the code I have written myself.
  239.  
  240. Parts of PS2EPS+ is copyright by Symantec Corporation, 10201 Torre Avenue,
  241. Cupertino, CA 95014-2132
  242.  
  243. Ghostscript is copyright by Free Software Foundation, Inc. 675 Mass Ave,
  244. Cambridge, MA 02139, USA
  245.  
  246. You may freely distribute copies of PS2EPS+ as long as you do so in an
  247. unmodified form and include all files and documentation which are present in
  248. this archive.
  249.  
  250. You are not allowed to make any profit on the distribution of PS2EPS+. 
  251.  
  252. The program may not be bundled with any kind of commercial products without a
  253. written consent from me.
  254.  
  255. Distribution on the Info-Mac CD is permitted.
  256.  
  257.  
  258. Disclaimer
  259.  
  260. PS2EPS+ is freeware and the author, Peter Lerup, makes no warranties, either
  261. expressed or implied, regarding the fitness of this program for any
  262. particular purpose. 
  263.  
  264. Use PS2EPS+ at your own risk. The author claims no liability for data loss or
  265. other problems caused directly or indirectly by PS2EPS+.
  266.  
  267. A disclaimer for Ghostscript can be found in the license file in the folder
  268. GS.
  269.  
  270.  
  271. Trademarks
  272.  
  273. PostScript is a registred trademark of Adobe Systems.
  274. Apple, Macintosh, Finder, MultiFinder and System 7 are registred trademarks of
  275. Apple Computer.
  276. Microsoft and Windows are registred trademarks of Microsoft Corporation.
  277.  
  278.  
  279. Author
  280.  
  281. Peter Lerup
  282. Ribevègen 11B
  283. S-217 46  MALMà
  284. SWEDEN
  285.  
  286. E-Mail:
  287. Internet:    ptl@automation.alfalaval.se
  288. Compuserve:    100136,2165
  289.  
  290.  
  291.